---
title: SAIF.Business.Utilities overview
summary: High-level purpose, scope, and responsibilities for this library.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-08-21
library: SAIF.Business.Utilities
reference_type: embedded
---

# SAIF.Business.Utilities overview

> **Documentation context:** Front-End Application Component
> **Documented via:** LegalMaintenance (LegalMaintenance.sln)

A stateless text-formatting utility library that normalizes legacy uppercase-stored text into display-ready casing and renders numbers as English words. Despite its `SAIF.Business.*` name, this library contains no business entities, BOF business objects, persistence, or service calls — it is pure, side-effect-free formatting.

## Purpose
- Convert free-form name/address/description text (typically all-caps legacy data) into display-ready title case while preserving original delimiter characters via `TitleCase.ToTitleCase` and its extension-method façade.
- Render whole numbers as English words (e.g. for written amounts on legal or printed output).
- Provide supporting string normalization utilities: sentence casing, proper casing, capital-letter padding, numeric validation.

## Responsibilities
- Title-case text using a rules-driven engine with recognizer lists for acronyms, minor words, irregular spellings, and ordinal suffixes.
- Validate and format strings for consistent display presentation across the application.
- Serve as a leaf formatting utility consumed by the view/presentation-model layer.

## Key components
- `TitleCase` (class) + `TitleCaseExtensions` (module): Rules-driven casing engine with extension-method surface for convenient string formatting.
- `mdlTextConversion` (module): Number-to-words conversion and sentence-case formatting, independent of title casing.

## Related documentation
- [Index](index.md)
- [Architecture](architecture.md)
- [Dependencies](dependencies.md)
- [Operations and processes](operations-processes.md)
- [Business rules](business-rules.md)
- [API reference](api/index.md)

## Sources
- `SAIF.Business.Utilities/SAIF.Business.Utilities.vbproj`
- `SAIF.Business.Utilities/TitleCase.vb`
- `SAIF.Business.Utilities/mdlTextConversion.vb`
- `SAIF.Business.Utilities/My Project/AssemblyInfo.vb`